UpdateAlias

Update an AliasRecord

#include <Aliases.h> Alias Manager

OSErr UpdateAlias( fromFile, target, alias, wasChanged);

FSSpec * fromFile; points to an FSSpec record specifying the starting

point for a relative path

FSSpec * target; points to the target of the AliasRecord

AliasHandle alias ; a handle to the AliasRecord to be updated

Boolean *wasChanged ; TRUE = a change has taken place

returns Error Code; 0=no error

You use the UpdateAlias function to update an AliasRecord.

fromFile represents the starting point for a relative path, to be used later in

a relative search. If you do not need relative path information in the

record, pass a fromFile value of NIL. If you want UpdateAlias to

record relative path information, pass a pointer to a valid FSSpec

record in this parameter. The two files or directories, fromFile and

target, must reside on the same volume.

target is the target of the AliasRecord This parameter must be a valid

FSSpec record.

alias is a handle to the AliasRecord to be updated.

wasChanged is a Boolean value. If the newly constructed AliasRecord.is exactly

the same as the old one, UpdateAlias sets the wasChanged parameter

to FALSE. Otherwise, it sets it to TRUE. Check this parameter to

determine whether you need to save an updated record.

Returns: an operating system Error Code.

noErr (0) No error

paramErr (-50) Target, alias, or both are NIL, or the AliasRecord

is corrupt

Notes: UpdateAlias updates the AliasRecord pointed to by the alias parameter so

that it describes the target specified by the target parameter. UpdateAlias

rebuilds the entire AliasRecord, and fills it in as the NewAlias function

would.

UpdateAlias always creates a complete AliasRecord . When you update a

minimal AliasRecord with UpdateAlias, you convert the minimal record to

a complete record.

Referenced by (7):